home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / dmedia / dmParamsScan.z / dmParamsScan
Encoding:
Text File  |  1998-10-20  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn((((3333ddddmmmm))))                                            ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn - scan all entries of a digital media parameter/value list
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ddddmmmm____ppppaaaarrrraaaammmmssss....hhhh>>>>
  13.  
  14.      DDDDMMMMssssttttaaaattttuuuussss ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn
  15.             (((( ccccoooonnnnsssstttt DDDDMMMMppppaaaarrrraaaammmmssss**** ppppaaaarrrraaaammmmssss,,,,
  16.              DDDDMMMMssssttttaaaattttuuuussss ((((****ssssccccaaaannnnFFFFuuuunnnncccc))))
  17.              (((( ccccoooonnnnsssstttt DDDDMMMMppppaaaarrrraaaammmmssss**** ppppaaaarrrraaaammmmssss,,,,
  18.                ccccoooonnnnsssstttt cccchhhhaaaarrrr**** ppppaaaarrrraaaammmmNNNNaaaammmmeeee,,,,
  19.                vvvvooooiiiidddd**** ssssccccaaaannnnAAAArrrrgggg,,,,
  20.                DDDDMMMMbbbboooooooolllleeeeaaaannnn**** ssssttttooooppppSSSSccccaaaannnn )))),,,,
  21.               vvvvooooiiiidddd**** ssssccccaaaannnnAAAArrrrgggg ))))
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn scans all of the elements present in a parameter/value list,
  25.      calling the provided operator function on each entry.  This can be used
  26.      in a program that wants to loop through the contents of a parameter/value
  27.      list.
  28.  
  29.      ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn applies scanFunc to each element in a parameter/value list,
  30.      passing the name of the list entry and scanArg as parameters to scanFunc.
  31.      If scanFunc sets the value of the variable stopScan to DDDDMMMM____TTTTRRRRUUUUEEEE, the
  32.      parameter/value list scan will be stopped, and the return value from
  33.      scanFunc will be returned by dmParamsScan.  Otherwise, ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn will
  34.      process all elements in the list and return DDDDMMMM____SSSSUUUUCCCCCCCCEEEESSSSSSSS.
  35.  
  36.      The following example will print the contents of a parameter/value list:
  37.  
  38. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  39.           DMstatus
  40.           PrintParam(const DMparams *params, const char *paramName,
  41.                void *arg, DMboolean *pstop)
  42.           {
  43.               printf ("%s=", paramName);
  44.  
  45.               switch(dmParamsGetType(params, paramName)) {
  46.               case DM_TYPE_INT:
  47.                printf ("%d(int)0, dmParamsGetInt(params, paramName));
  48.                break;
  49.               case DM_TYPE_LONG_LONG:
  50.                printf ("%lld(longlong)0, dmParamsGetLongLong(params, paramName));
  51.                break;
  52.               case DM_TYPE_FLOAT:
  53.                printf ("%3.3f(float)0, dmParamsGetFloat(params, paramName));
  54.                break;
  55.               default:
  56.                printf ("type(%d)0, dmParamsGetType(params, paramName));
  57.                break;
  58.               }
  59.               return DM_SUCCESS;
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn((((3333ddddmmmm))))                                            ddddmmmmPPPPaaaarrrraaaammmmssssSSSSccccaaaannnn((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.           }
  75.  
  76.           void
  77.           PrintParams(DMparams *params)
  78.           {
  79.               printf ("Contents of Parameter/Value List:0);
  80.  
  81.               (void)dmParamsScan(params, PrintParam, 0);
  82.           }
  83.  
  84.  
  85. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.      dmParams(3dm).
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.